LEGION Simulator Help

Track Properties

Each track you place on the Timeline has certain properties which need to be defined correctly in order for playback and recording to occur and for specified events to run successfully. You can access a track’s properties by right-clicking on it and selecting Track properties.

For instance, if saving data files (Maps, Graphs, snapshots, ‘avi’ files or ‘res’ files), you need to define where you want to save the files, what you want to call the files and whether you are saving one file or multiple files.

If these properties are undefined, or defined incorrectly, the track status icon will indicate a warning or an error, which will also be visible in the ‘QA’ portion of the Output Bar.

The following procedures describe how to set properties for the various Analysis Timeline tracks.

Setting the Maps Track Properties

Maps track properties require you to define names and locations for any data files you want to save for one or more Save Map events. This procedure assumes that you have the ‘Maps Track Properties’ dialog box open.

To set Maps Track Properties:

  1. Under File Usage, select one of the options:
    • Save all data to a single file - select if you only intend to save a single map at one specific time within the simulation. Go to step 2.
    • Save all data to multiple files - select if you intend to save two or more maps at one or several times within the simulation. Go to step 5.
  2. Next to Single File Setup, click the browse button to display the ‘Save As’ dialog.
    Tip: The Folder can be a relative path, relative to the Project Base Folder.
  3. Navigate to the location you want to save the file, enter a name for the file and click Save.
    Note: If the location is in the Project Base Folder, or in a subfolder thereof, it is automatically converted to a relative path.
  4. Click OK to close the ‘Save As’ dialog.
  5. Next to Folder, click the browse button and either select an existing folder or create a new one. This is where your multiple files will be saved.
    Tip: The Folder can be a relative path, relative to the Project Base Folder.
    Note: If the location is in the Project Base Folder, or in a subfolder thereof, it is automatically converted to a relative path.
  6. From the Templates drop-down list, select one of the available combinations of information to be saved as part of your filenames (these include Date, Time, Object Name, Event Name, Model Time, Time). These template elements are added to the Base filename box.
    Tip: The Example box at the bottom of the dialog shows how the files will be named.
  7. To add your own filename prefix, enter it in the Base filename box, taking care not to overwrite any template elements listed there.
    • File iteration separators and numbering style are automatically defined.
  8. Click the Track Info tab and check or uncheck the box labelled Enable this track to make the track active or inactive.
  9. Click OK to close the ‘Maps Track Properties’ dialog.

Setting the Graphs Track Properties

Graphs track properties require you to define names and locations for any data files you want to save for one or more Save Graph events. The procedure is the same as that described in "Setting the Maps track properties" above.

Setting the Screen Camera Track Properties

Screen Camera track properties require you to define names and locations for any data files you want to save for one or more Snapshot events. The procedure is the same as that described in "Setting the Maps track properties" above.

Setting Track properties for Record .AVI and ‘res’ tracks

The properties of these types of track can be set by following the procedures in Set the Record .RES track properties and Set the Record .AVI Track Properties.

Setting the Record Entity Positions Track Properties

Record Entity Positions track properties require you to define names and locations for any XML files you want to save. This procedure assumes that you have the ‘Record Entity Positions Properties’ dialog box open.

To set the Record Entity Positions track properties:

  1. Next to Filename to save to, click the browse button to display the ‘Save As’ dialog.
    Tip: The Filename to save to can be a relative path, relative to the Project Base Folder.
  2. Navigate to the location where you would like to save the Entity position file, enter a name, and click Save.
    Note: If the location is in the Project Base Folder, or in a subfolder thereof, it is automatically converted to a relative path.
  3. To record Entity positions in a specified area covered by an Analysis Zone, check the box labelled Use region and select an area from the drop-down list labelled Analysis Zone.
  4. To change the default Save frequency of 0.6 seconds, enter a new value in the box labelled Save entity positions every n seconds.
  5. Click OK.
A new track called (in this case) ‘Record Entity Positions’ is added to the Timeline.

Setting the Save 15-minute Underground Maps track properties

To set track properties:

  1. Right-click on the Save 15-minute Underground maps track and select Track properties...
  2. Under File Usage, select one of the options:
    • Save all data to a single file - select if you only intend to save a single map at one specific time within the simulation. Go to step 3.
    • Save all data to multiple files - select if you intend to save two or more maps at one or several times within the simulation. Go to step 7.
  3. Under Single File Setup, click the browse button to display the 'Browse For Folder’ dialog.
    Tip: The Folder can be a relative path, relative to the Project Base Folder.
  4. Navigate to the location you want to save the file and click OK.
    Note: If the location is in the Project Base Folder, or in a subfolder thereof, it is automatically converted to a relative path.
  5. In the field labelled File title, enter your preferred name for the file.
  6. Click OK to close the ‘Maps Track Properties’ dialog.
  7. Under Multiple Files Setup, click the browse button to display the 'Browse For Folder’ dialog.
  8. Navigate to the location where you want to save the file and click OK.
    Tip: The Folder can be a relative path, relative to the Project Base Folder.
    Note: If the location is in the Project Base Folder, or in a subfolder thereof, it is automatically converted to a relative path.
  9. From the Templates drop-down list, select one of the available combinations of information to be saved as part of your filenames (these include Date, Time, Object Name, Event Name, Model Time, Time). These template elements are added to the Base filename box.
    Tip: The Example box at the bottom of the dialog box shows you how the files will be named.
  10. To add your own filename prefix, enter it in the ‘Base filename’ box, taking care not to overwrite any template elements listed there.
    • File iteration separators and numbering style are automatically defined.
  11. Click the Track Info tab and check or uncheck the box labelled Enable this track to make the track active or inactive.
  12. Click OK to save your changes.

Setting the Save 60-minute Underground Maps track properties

Follow the steps as in "Setting the Save 15-minute Underground Maps track properties", above.